home *** CD-ROM | disk | FTP | other *** search
/ Web Page Construction Kit 3.0 / Web Page Construction Kit 3.0.iso / pc / source / 3rdparty / cgi / libs / gdpm / readme.txt < prev   
Encoding:
Text File  |  1996-07-17  |  3.1 KB  |  91 lines
  1. GD.pm A perl5 interface to Thomas Boutell's gd library.
  2.  
  3. ABSTRACT:
  4.  
  5. This is a autoloadable interface module for libgd, a popular library
  6. for creating and manipulating GIF files.  With this library you can
  7. create GIF images on the fly or modify existing files.  Features
  8. include:
  9.  
  10. a.  lines, polygons, rectangles and arcs, both filled and unfilled
  11. b.  flood fills
  12. c.  the use of arbitrary images as brushes and as tiled fill patterns
  13. d.  line styling (dashed lines and the like)
  14. e.  horizontal and vertical text rendering
  15. f.  support for transparency and interlacing
  16.  
  17. For full information on usage, see the accompanying man and html
  18. documentation.
  19.  
  20. COPYRIGHT INFO
  21.  
  22. The GD.pm interface is copyright 1995, Lincoln D. Stein.  You are free
  23. to use it for any purpose, commercial or noncommercial, provided that
  24. if you redistribute the source code this statement of copyright
  25. remains attached. The Gd library is covered separately, under a 1994
  26. copyright by Quest Protein Database Center, Cold Spring Harbor Labs.
  27. For usage information see the Gd documentation at the URL given below.
  28.  
  29. INSTALLATION:
  30.  
  31. 1.  You'll need the following:
  32.     a.  perl 5.001 or higher:
  33.         ftp://ftp.netlabs.com/pub/outgoing/perl5.0
  34.         (and many other places)
  35.     b.  libgd.a
  36.         http://www.boutell.com/gd/
  37.  
  38.     If you haven't already, configure and build them according to their
  39.     instructions.  For best results, make sure they're installed
  40.     in more-or-less "standard" places, e.g. /usr/local/bin/perl
  41.     ,/usr/local/lib/libgd.a, and /usr/local/include/gd.h.
  42.  
  43.     Note: After you build libgd.a you may see linker warnings
  44.     about it not having a table of contents.  This seems
  45.     to be harmless (at least on the systems I use), but you 
  46.     can run ranlib on libgd.a to get rid of the warnings.
  47.  
  48. 2.  Unpack the tar file and install in the perl source tree with the
  49.     other external utilities, e.g. perl5.001/ext/GD/
  50.  
  51. 3.  If you have dynamic linking, the rest is easy:
  52.  
  53.     a.  cd perl5.001/ext/GD
  54.     b.  perl Makefile.PL
  55.     c.  make
  56.     d.  make install
  57.  
  58. 4.  If you have static linking, you'll have to reconfigure and relink
  59.     perl:
  60.  
  61.     a.  cd perl5.001
  62.     b.  Configure
  63.     c.  When it asks you if you want to statically link GD,
  64.         answer YES
  65.     d.  make
  66.     e.  make install
  67.  
  68. 5.  There are some demos you can run in ext/GD/demos.  They print GIF
  69.     files to standard output.  To view the files, pipe their
  70.     output to display or xv in this way:
  71.  
  72.     a.  cd perl5.001/ext/GD/demos
  73.     b   shapes.pl | xv -
  74.  
  75. The current version is 1.01.  It is up to date with respect to gd version 1.2.
  76. When version 2.0 of gd is released, the new version of GD will be found at
  77.  
  78.     http://www-genome.wi.mit.edu/pub/software/WWW/GD.html
  79.  
  80. This interface has been tested on multiple systems.  A warning: you may
  81. experience problems compiling this interface using the built-in "make" and
  82. "cc" programs that Sun provides.  If this happens to you, obtain the GNU
  83. equivalents, "gmake" and "gcc".  You'll be thankful you did in the long run.
  84. If you encounter other problems on your system, drop me a
  85. line:
  86.  
  87.     Lincoln Stein
  88.     lstein@genome.wi.mit.edu
  89.     http://www-genome.wi.mit.edu/~lstein
  90.  
  91.